home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glnormal.z / glnormal
Encoding:
Text File  |  2002-10-03  |  6.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllNNNNoooorrrrmmmmaaaallll((((3333GGGG))))                   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                   ggggllllNNNNoooorrrrmmmmaaaallll((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllNNNNoooorrrrmmmmaaaallll3333bbbb,,,, ggggllllNNNNoooorrrrmmmmaaaallll3333dddd,,,, ggggllllNNNNoooorrrrmmmmaaaallll3333ffff,,,, ggggllllNNNNoooorrrrmmmmaaaallll3333iiii,,,, ggggllllNNNNoooorrrrmmmmaaaallll3333ssss,,,, ggggllllNNNNoooorrrrmmmmaaaallll3333bbbbvvvv,,,,
  10.      ggggllllNNNNoooorrrrmmmmaaaallll3333ddddvvvv,,,, ggggllllNNNNoooorrrrmmmmaaaallll3333ffffvvvv,,,, ggggllllNNNNoooorrrrmmmmaaaallll3333iiiivvvv,,,, ggggllllNNNNoooorrrrmmmmaaaallll3333ssssvvvv - set the current
  11.      normal vector
  12.  
  13.  
  14. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  15.      void ggggllllNNNNoooorrrrmmmmaaaallll3333bbbb( GLbyte _n_x,
  16.                       GLbyte _n_y,
  17.                       GLbyte _n_z )
  18.      void ggggllllNNNNoooorrrrmmmmaaaallll3333dddd( GLdouble _n_x,
  19.                       GLdouble _n_y,
  20.                       GLdouble _n_z )
  21.      void ggggllllNNNNoooorrrrmmmmaaaallll3333ffff( GLfloat _n_x,
  22.                       GLfloat _n_y,
  23.                       GLfloat _n_z )
  24.      void ggggllllNNNNoooorrrrmmmmaaaallll3333iiii( GLint _n_x,
  25.                       GLint _n_y,
  26.                       GLint _n_z )
  27.      void ggggllllNNNNoooorrrrmmmmaaaallll3333ssss( GLshort _n_x,
  28.                       GLshort _n_y,
  29.                       GLshort _n_z )
  30.  
  31.  
  32. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  33.      _n_x, _n_y, _n_z
  34.                Specify the x, y, and z coordinates of the new current normal.
  35.                The initial value of the current normal is the unit vector, (0,
  36.                0, 1).
  37.  
  38. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  39.      void ggggllllNNNNoooorrrrmmmmaaaallll3333bbbbvvvv( const GLbyte *_v )
  40.      void ggggllllNNNNoooorrrrmmmmaaaallll3333ddddvvvv( const GLdouble *_v )
  41.      void ggggllllNNNNoooorrrrmmmmaaaallll3333ffffvvvv( const GLfloat *_v )
  42.      void ggggllllNNNNoooorrrrmmmmaaaallll3333iiiivvvv( const GLint *_v )
  43.      void ggggllllNNNNoooorrrrmmmmaaaallll3333ssssvvvv( const GLshort *_v )
  44.  
  45.  
  46. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  47.      _v    Specifies a pointer to an array of three elements:  the x, y, and z
  48.           coordinates of the new current normal.
  49.  
  50. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  51.      The current normal is set to the given coordinates whenever ggggllllNNNNoooorrrrmmmmaaaallll is
  52.      issued.  Byte, short, or integer arguments are converted to floating-
  53.      point format with a linear mapping that maps the most positive
  54.      representable integer value to 1.0, and the most negative representable
  55.      integer value to -1.0.
  56.  
  57.      Normals specified with ggggllllNNNNoooorrrrmmmmaaaallll need not have unit length.  If
  58.      GGGGLLLL____NNNNOOOORRRRMMMMAAAALLLLIIIIZZZZEEEE is enabled, then normals of any length specified with
  59.      ggggllllNNNNoooorrrrmmmmaaaallll are normalized after transformation.  If GGGGLLLL____RRRREEEESSSSCCCCAAAALLLLEEEE____NNNNOOOORRRRMMMMAAAALLLL is
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllNNNNoooorrrrmmmmaaaallll((((3333GGGG))))                   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                   ggggllllNNNNoooorrrrmmmmaaaallll((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      enabled, normals are scaled by a scaling factor derived from the
  75.      modelview matrix.  GGGGLLLL____RRRREEEESSSSCCCCAAAALLLLEEEE____NNNNOOOORRRRMMMMAAAALLLL requires that the originally
  76.      specified normals were of unit length, and that the modelview matrix
  77.      contain only uniform scales for proper results.  To enable and disable
  78.      normalization, call ggggllllEEEEnnnnaaaabbbblllleeee and ggggllllDDDDiiiissssaaaabbbblllleeee with either GGGGLLLL____NNNNOOOORRRRMMMMAAAALLLLIIIIZZZZEEEE or
  79.      GGGGLLLL____RRRREEEESSSSCCCCAAAALLLLEEEE____NNNNOOOORRRRMMMMAAAALLLL.  Normalization is initially disabled.
  80.  
  81. NNNNOOOOTTTTEEEESSSS
  82.      The current normal can be updated at any time.  In particular, ggggllllNNNNoooorrrrmmmmaaaallll
  83.      can be called between a call to ggggllllBBBBeeeeggggiiiinnnn and the corresponding call to
  84.      ggggllllEEEEnnnndddd.
  85.  
  86. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  87.      ggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____NNNNOOOORRRRMMMMAAAALLLL
  88.      ggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____NNNNOOOORRRRMMMMAAAALLLLIIIIZZZZEEEE
  89.      ggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____RRRREEEESSSSCCCCAAAALLLLEEEE____NNNNOOOORRRRMMMMAAAALLLL
  90.  
  91.  
  92. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  93.      ggggllllBBBBeeeeggggiiiinnnn, ggggllllCCCCoooolllloooorrrr, ggggllllIIIInnnnddddeeeexxxx, ggggllllNNNNoooorrrrmmmmaaaallllPPPPooooiiiinnnntttteeeerrrr, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd, ggggllllVVVVeeeerrrrtttteeeexxxx
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.